Vcenter Ovf Property

Vcenter Ovf Property
Vcenter Ovf Property

The Vcenter Ovf Property schema contains the information about a property in an OVF package.

A property is uniquely identified by its [classid.]id[.instanceid] fully-qualified name (see Vcenter Ovf Property.class_id, Vcenter Ovf Property.id, and Vcenter Ovf Property.instance_id). If multiple properties in an OVF package have the same fully-qualified name, then the property is excluded and cannot be set. We do warn about this during import.

See POST /vcenter/ovf/library-item/{ovfLibraryItemId}?action=deploy and POST /vcenter/ovf/library-item/{ovfLibraryItemId}?action=filter.

JSON Example
{
    "class_id": "string",
    "id": "string",
    "instance_id": "string",
    "category": "string",
    "ui_optional": false,
    "label": "string",
    "description": "string",
    "type": "string",
    "value": "string"
}
string
class_id
Optional

The classId of this OVF property.

This property is not used in the input parameters when deploying an OVF package. This property will always be present in the result when retrieving information about an OVF package.

string
id
Optional

The identifier of this OVF property.

This property must be provided in the input parameters when deploying an OVF package. This property will always be present in the result when retrieving information about an OVF package.

string
instance_id
Optional

The instanceId of this OVF property.

This property is not used in the input parameters when deploying an OVF package. This property will always be present in the result when retrieving information about an OVF package.

string
category
Optional

If this is set to a non-empty string, this property starts a new category.

This property is not used in the input parameters when deploying an OVF package. This property is optional in the result when retrieving information about an OVF package. If missing or null, the property is in the same category as the previous item, otherwise, it starts a new category.

boolean
ui_optional
Optional

Whether a category is UI optional. This is only used if this property starts a new category (see Vcenter Ovf Property.category).

The value is stored in an optional attribute vmw:uioptional to the ovf:Category element. The default value is false. If this value is true, the properties within this category are optional. The UI renders this as a group with a check box, and the group is grayed out until the check box is selected. When the check box is selected, the input values are read and used in deployment. If properties within the same category specify conflicting values the default is used. Only implemented in vSphere Web Client 5.1 and later as of Nov 2012.

This property is not used in the input parameters when deploying an OVF package. This property is optional in the result when retrieving information about an OVF package.

string
label
Optional

The display name of this OVF property.

This property is not used in the input parameters when deploying an OVF package. This property will always be present in the result when retrieving information about an OVF package.

string
description
Optional

A description of this OVF property.

This property is not used in the input parameters when deploying an OVF package. This property is optional in the result when retrieving information about an OVF package.

string
type
Optional

The type of this OVF property. Refer to the configuration of a virtual appliance/virtual machine for the valid values.

This property is not used in the input parameters when deploying an OVF package. This property will always be present in the result when retrieving information about an OVF package.

string
value
Optional

The OVF property value. This contains the default value from ovf:defaultValue if ovf:value is not present when read.

This property must be provided in the input parameters when deploying an OVF package. This property will always be present in the result when retrieving information about an OVF package.